std::basic_string::copy

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++0x feature) Atomic operations library (C++0x feature) Thread support library (C++0x feature)
Strings library
Narrow character strings Wide character strings Classes basic_string char_traits Functions getline stoi stol stoll stoul stoull (C++0x) (C++0x) (C++0x) (C++0x) (C++0x) stof stod stold (C++0x) (C++0x) (C++0x) to_string (C++0x) to_wstring (C++0x)
std::basic_string
Member functions basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator Element access basic_string::at basic_string::operator[] basic_string::front (C++0x) basic_string::back (C++0x) basic_string::data basic_string::c_str Iterators basic_string::begin basic_string::end basic_string::rbegin basic_string::rend Capacity basic_string::empty basic_string::size basic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit Operations basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back basic_string::append basic_string::operator+= basic_string::compare basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap Search basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of Constants basic_string::npos

​size_type copy( CharT* dest,                 size_type count,                 size_type pos = 0);​

Copies a substring [pos, pos+count) to character string pointed to by s. If the requested substring lasts past the end of the string, or if ​count == npos​, the copied substring is [pos, size()). The resulting character string is not null-terminated.

If ​pos > size()​, out_of_range is thrown.

Contents 1 Parameters 2 Return value 3 Complexity 4 Example 5 See also

Parameters

dest	-	pointer to the destination character string
pos	-	position of the first character to include
count	-	length of the substring

Return value

number of characters copied

Complexity

linear in count

Example

This section is incomplete

See also

substr	returns a substring (public member function)